home *** CD-ROM | disk | FTP | other *** search
/ SGI Developer Toolbox 6.1 / SGI Developer Toolbox 6.1 - Disc 4.iso / public / xpd / README next >
Text File  |  1994-08-01  |  3KB  |  72 lines
  1.  
  2.                           toolbox/public/xpd README
  3.  
  4.  
  5.     Up through version 3.2 of the Developer Toolbox, we provided sgi inst-
  6.     able images of release 4.035 of the Practical Extraction and Report 
  7.     Language otherwise known as Perl.  As of 5.1 Irix, this software now is
  8.     bundled in the eoe2.sw.gifts_perl subsystem.  For more information see 
  9.     the Frequently Asked Questions perl file located at 
  10.     ~4Dgifts/toolbox/FAQs/netfaqs/perl-faq.
  11.  
  12.  
  13.  
  14.     The following sgi inst-able images contain xpd, the graphical perl 
  15.     debugger compiled on 5.1 Irix with shared motif libraries (part of the
  16.     Indigo Magic desktop environment), hence now xpd includes the schemes
  17.     and sgi look-and-feel stuff.  
  18.     
  19.     This software is provided as is without any warranty of any kind, 
  20.     express or otherwise, etc., etc., etc.  IF any bugs are discovered,
  21.     please send word to dave@sgi.com, 415/390-3556, fax--415/967-6239.  We
  22.     will do our best to resolve any such issues, but time constraints and
  23.     prior commitments may prevent such solutions from being enacted.
  24.  
  25.  
  26.  
  27.     From the top of the XPD(1) man page:
  28.  
  29.  
  30.  
  31.      XPD(1)                   Internal Tools                    XPD(1)
  32.  
  33.      NAME
  34.           xpd - Graphical interface to the perl debugger.
  35.  
  36.      SYNOPSIS
  37.           xpd <perl script and its command line args>
  38.  
  39.      DESCRIPTION
  40.           Xpd is  a  Motif  based  graphical  interface  to  the  perl
  41.           debugger.   It  has  some  of the traditional features you'd
  42.           expect from a graphical debugger interface such  as  showing
  43.           where you are in the source file, setting visual breakpoints
  44.           and deleting them with the mouse, clicking on variables  and
  45.           printing their values, etc.
  46.  
  47.           Unlike most C debuggers, you must specify more than just the
  48.           script  name  to  be  debugged on the xpd command line.  You
  49.           must type not only the script name,  but  also  its  command
  50.           line  options.   Once in xpd, you are already in `run' mode,
  51.           waiting to execute the first executable  line  in  the  main
  52.           program.   For  example,  let  us say you have a perl script
  53.           called `foofum' and its misbehaving when you invoke it thus:
  54.  
  55.                foofum -h toeman -t /usr/tmp
  56.  
  57.           To run it under xpd you'd type:
  58.  
  59.                xpd foofum -h toeman -t /usr/tmp
  60.  
  61.           Two windows will come  up  on  your  display.   The  topmost
  62.           window  is  the  main guts of xpd and shows the source file,
  63.           breakpoints, current executable line, and a set  of  buttons
  64.           for  stepping,  nexting,  breaking,  printing, etc.  In this
  65.           window, directly under the source file  text  window,  is  a
  66.           single  line  text  window  where you can type perl debugger
  67.           commands directly.  The second smaller window represents the
  68.           debugger's  output  messages as well as any output your perl
  69.           script might produce.  You may also type into this window if
  70.           your perl script expects input from stdin.
  71.  
  72.